home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 551-575 / disk_558 / btntape / mess.doc < prev    next >
Text File  |  1992-05-06  |  6KB  |  142 lines
  1.                         BTN 2.1 MESSAGES
  2.  
  3. Here are the messages printed via TapeMon by the BTN handler (in no
  4. particular order), with explanations for each message.
  5.  
  6.  
  7. *** Sense: %s, other= %02X,%02X
  8.        Printed when the tape drive returns a SCSI "check condition"
  9.        in response to a SCSI command that BTN has sent to the drive.
  10.        Sometimes this may indicate an error or problem, but not always.
  11.        The reason for the condition is encoded into a "sense key"
  12.        which is spelled out for you in this message.  The SCSI spec
  13.        defines these keys:
  14.           NO SENSE - nothing unusual to report
  15.           RECOVERED ERROR - something went wrong, but the drive fixed it up
  16.           NOT READY - human intervention is required (insert tape)
  17.           MEDIUM ERROR - an unrecoverable flaw in the tape material
  18.           HARDWARE ERROR - the drive is broken (still have your receipt?)
  19.           ILLEGAL REQUEST - the SCSI command/function is not supported by
  20.             this drive, or there are bits in the command that the drive
  21.             doesn't like, or the drive is being asked to do something
  22.             it doesn't feel like doing right now.
  23.           UNIT ATTENTION - a transient condition generated whenever a
  24.             new tape is inserted.
  25.           DATA PROTECT - the tape medium is write protected
  26.           BLANK CHECK - the drive has attempted to read a place that has
  27.             never been written or has been erased.
  28.           FILEMARK - the drive has attempted to read a filemark, which
  29.             indicates the end of the file has been reached.
  30.           END-OF-MEDIUM - the drive has reached physical end of the tape
  31.           VOLUME OVERFLOW - some drives indicate this at end of tape
  32.           INCORRECT LENGTH - BTN asked to read a block smaller than
  33.             what was written on the tape.  BS is probably incorrect.
  34.  
  35.        The "other" bytes printed are bytes 12 and 13 of the sense data.
  36.        For some drives, such as the MCD-40 and SCSI-2 drives, this is
  37.        a subcode indicating more information about the sense key.
  38.  
  39. *** SCSI %s ERROR
  40.        The scsi-direct driver/adapter returned an error in response to BTN's
  41.        attempt to send a SCSI command to the drive.  These errors are
  42.        defined by Commodore:
  43.           SELF-UNIT - the UN number is the same as that of the SCSI adapter
  44.           DMA - I don't know what this means.  Maybe an adapter problem.
  45.           PHASE - the drive and the SCSI adapter are not in-sync with
  46.              their SCSI phases.  There may be a mismatch in data transfer.
  47.           PARITY - a parity error on the SCSI bus
  48.           SELECT-TIMEOUT - the adapter timed out waiting for a response
  49.              from the drive.
  50.  
  51. *** Can't get %u bytes for tape buffers
  52.        There is insufficient memory to allocate two buffers of NB*BS
  53.        bytes (or maybe the memory is too fragmented).  Use a smaller
  54.        value for NB, or free up some memory, or reboot.
  55.  
  56. *** Invalid open name/combo %s
  57.        * The name used to access the tape file is unrecognized.
  58.           The name must be one of the following:  TAPE:  TAPE:R
  59.             TAPE:APP  TAPE:NR  TAPE:*  TAPE:number  TAPE:RAWCMD  TAPE:MODESEL
  60.        * The function is incompatible with the open mode or drive model.
  61.           Examples: you cannot read from TAPE:APP, and TAPE:APP is always
  62.           invalid for direct access drives.
  63.  
  64. *** Current block size = %u
  65. *** Mode Select block size %d
  66.        Informative messages printed when the BS value is different than
  67.        the block size of the drive.  BTN will attempt to command the
  68.        drive to switch to the new size.
  69.  
  70. *** Capacity: %u blocks
  71.        Informative message printed only for direct access drives describing
  72.        the number of blocks available on this particular cartridge.
  73.  
  74. *** %s Opened at block %u
  75.        Informative message printed when Open() is successful.
  76.  
  77. *** Closed at block %u
  78.        Informative message printed when Close() is finished.
  79.        The block number is the next available block.  The tape head
  80.        is positioned ready to access this block for the next operation.
  81.  
  82. *** Function/mode error
  83.        The application is attempting to mix Read()s and Write()s.
  84.        It can't read while opened for writes, and vice versa.
  85.  
  86. *** Disallowed seek type=%d off=%d curr=%d
  87.        A Seek() request was rejected because the type of seek is not
  88.        supported or it cannot be done at this point.
  89.  
  90. *** Error during read
  91. *** Error during write
  92.        Indicates that -1 was returned for a Read() or Write() request.
  93.  
  94. *** Unsupported_Pkt=%d
  95.        Informative message indicating that an AmigaDOS packet was
  96.        rejected as "unknown", because the requested function does
  97.        not apply to BTN.  Not usually a problem.
  98.  
  99. *** Skipping to end of data
  100. *** (doing it the hard way)
  101.        Informative message printed when Open()ing TAPE:APP.  If the
  102.        drive doesn't directly support this function, the "hard way"
  103.        message is printed, and BTN begins skipping individual files.
  104.  
  105. *** Skipping to file %d
  106.        Informative message printed when reading from TAPE:number
  107.        on a sequential drive.
  108.  
  109. *** Unable to position tape
  110.        Printed when some kind of error occurs when BTN tries to get
  111.        the tape into the necessary position for Open().  You will
  112.        get a "replace volume" requester.
  113.  
  114. *** Time to insert tape# %d
  115.        Informative message printed at end of tape.  Also a requester.
  116.  
  117. *** Writing block %u x %d
  118. *** Reading block %u x %d
  119.        Informative messages printed just before a SCSI read or write
  120.        command is sent to the drive.  The block number is relative
  121.        to the beginning of the file for sequential drives, and is
  122.        the actual block number for direct access drives.  The length
  123.        is the number of blocks (NB).
  124.  
  125. *** Rewinding
  126.        Informative message printed when a rewind is started.
  127.  
  128. *** Writing filemark
  129.        Informative message printed when Close()ing a file being written.
  130.  
  131. *** Retensioning
  132.        Informative message printed when Unit Attention status occurs and
  133.        RT-1 was specified in the mountlist.  The retensioning operation
  134.        may take several minutes to complete.
  135.  
  136. *** Raw command %02X
  137.        Informative message printed when writing to TAPE:RAWCMD.
  138.  
  139. *** User Mode-Select
  140.        Informative message printed when writing to TAPE:MODESEL.
  141.  
  142.